<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01//ZH-CN" "http://www.w3.org/TR/html4/strict.dtd">
<html>
<head>
	<meta http-equiv="Content-Type" content="text/html; charset=utf-8" />
	<meta http-equiv="imagetoolbar" content="no" />
	<title>Class UI.Upload</title>
	<link href="../resources/API_Help.css" type="text/css" rel="stylesheet" />
</head>

<body>
<!--打印本页-->
<div class="printCurrentPage">
	<img src="../resources/image/print.gif" align="absmiddle" />&nbsp;
	<a href="ui_Upload_API.html" target="_blank">打印本页</a>
</div><br/>

<!--标题说明-->
<h1>Class UI.Upload</h1>
<b>定义于文件：</b>&nbsp;&nbsp;ui_upload.js
<div class="description">将页面对象渲染成多文件上传域控件。</div><br/>
<b>基本语法</b>
<div class="syntax">var upload = new <b>UI.Upload</b>( { &lt; <em>id:String|Tag</em>,&nbsp;&nbsp;<em>name:String</em>,&nbsp;&nbsp;<em>form:String</em> &gt; [ , <em>size:Number</em> ] } );</div>
<b>参数说明</b>
<div class="parameter">
	<ul>
		<li><em>id</em> : String|Tag</li>
		<div class="subDesc">页面多文件上传域标签ID或是页面多文件上传域控件标签对象。</div>
		<li><em>name</em> : String</li>
		<div class="subDesc">多文件上传域控件的名字, 提交时, 后台通过多文件上传域控件的名字取得上传数据, 默认值：id。</div>
		<li><em>form</em> : String</li>
		<div class="subDesc">多文件上传域控件所在的表单ID。</div>
		<li><em>size</em> : Number</li>
		<div class="subDesc">(可选参数) 多文件上传域控件最多可添加的文件数量, 默认值：1。</div>
	</ul>
</div>
<b>页面标签对象原型</b>
<div class="parameter">
	&lt;div&gt;&lt;/div&gt;
</div>
<b>依赖关系</b>
<div class="parameter">
	<a href="core_API.html">core.js</a>　　<a href="#">webui.js</a>
</div><br/>
<a href="#properties">相关属性</a>&nbsp;&nbsp;-&nbsp;&nbsp;
<a href="#methods">相关方法</a>&nbsp;&nbsp;-&nbsp;&nbsp;
<a href="#events">相关事件</a>&nbsp;&nbsp;-&nbsp;&nbsp;
<a href="#examples">应用示例</a>
<hr>

<!--相关属性-->
<a name="properties"></a>
<h2>相关属性</h2>
<table width="100%" cellspacing="0">
	<tbody>
		<tr>
			<td class="tableHead" width="83%">所有属性</td>
			<td class="tableHead" width="17%">所属类</td>
		</tr>
		<tr>
			<td class="tableLineLeft">
				<a href="#UI.Upload.dom" class="methodLink">UI.Upload.dom</a>&nbsp;:&nbsp;&lt;div&gt;<br/>
				多文件上传域控件的页面标签对象。
			</td><td class="tableLineRight">UI.Upload</td>
		</tr>
	</tbody>
</table>

<!--相关方法-->
<a name="methods"></a>
<h2>相关方法</h2>
<table width="100%" cellspacing="0">
	<tbody>
		<tr>
			<td class="tableHead" width="83%">所有方法</td>
			<td class="tableHead" width="17%">所属类</td>
		</tr>
		<tr>
			<td class="tableLineLeft">
				<a href="#onDelFile" class="methodLink">onDelFile</a>( <em>callBack:Function</em> )&nbsp;:&nbsp;none<br/>
				设置控件文件删除动作事件回调。
			</td><td class="tableLineRight">UI.Upload</td>
		</tr>
		<tr>
			<td class="tableLineLeft alt">
				<a href="#onFileClick" class="methodLink">onFileClick</a>( <em>callBack:Function</em> )&nbsp;:&nbsp;none<br/>
				设置控件列表文件单击动作事件回调。
			</td><td class="tableLineRight alt">UI.Upload</td>
		</tr>
		<tr>
			<td class="tableLineLeft">
				<a href="#onSubmit" class="methodLink">onSubmit</a>( <em>callBack:Function</em> )&nbsp;:&nbsp;none<br/>
				设置控件上传提交动作事件回调。
			</td><td class="tableLineRight">UI.Upload</td>
		</tr>
		<tr>
			<td class="tableLineLeft alt">
				<a href="#reset" class="methodLink">reset</a>()&nbsp;:&nbsp;none<br/>
				复位多文件上传域控件。
			</td><td class="tableLineRight alt">UI.Upload</td>
		</tr>
	</tbody>
</table>

<!--相关事件-->
<a name="events"></a>
<h2>相关事件</h2>
<table width="100%" cellspacing="0">
	<tbody>
		<tr>
			<td class="tableHead" width="83%">所有事件</td>
			<td class="tableHead" width="17%">所属类</td>
		</tr>
		<tr>
			<td class="tableLineLeft">
				<a href="#UI.Upload.onDelFileEvent" class="methodLink">UI.Upload.onDelFileEvent</a>&nbsp;:&nbsp;Function<br/>
				控件的文件删除动作事件。
			</td><td class="tableLineRight">UI.Upload</td>
		</tr>
		<tr>
			<td class="tableLineLeft alt">
				<a href="#UI.Upload.onFileClickEvent" class="methodLink">UI.Upload.onFileClickEvent</a>&nbsp;:&nbsp;Function<br/>
				控件的列表文件单击作事件。
			</td><td class="tableLineRight alt">UI.Upload</td>
		</tr>
		<tr>
			<td class="tableLineLeft">
				<a href="#UI.Upload.onSubmitEvent" class="methodLink">UI.Upload.onSubmitEvent</a>&nbsp;:&nbsp;Function<br/>
				控件的上传提交动作事件。
			</td><td class="tableLineRight">UI.Upload</td>
		</tr>
	</tbody>
</table>
<br/>

<hr>

<!--相关属性的详细说明-->
<h2>本类属性的详细说明</h2>
<div class="detailWrap">

<a name="UI.Upload.dom"></a>
<div class="mdetail">
	<h3>UI.Upload.dom</h3><br/>
	<div class="mdetailDetails">
		多文件上传域控件的页面标签对象。<br/>
		通过 dom 属性可直接对控件进行操作。
	</div>
	<div class="footer since">@since JSR2.0&nbsp;&nbsp;&nbsp;&nbsp;<a href="ui_Upload_API.html">Return</a></div><br/>
</div>

</div><br/>

<!--相关方法的详细说明-->
<h2>本类方法的详细说明</h2>
<div class="detailWrap">

<a name="onDelFile"></a>
<div class="mdetail">
	<h3>onDelFile</h3>
	<div class="functionDefine">public function onDelFile( callBack:Function )</div>
	<div class="mdetailDetails">设置多文件上传域控件的 onDelFileEvent 动作事件回调。<br/>
	当删除控件列表中的文件时, 系统会自动调用 callBack 方法。</div><br/>
	<div class="mdetailDetails"><b>参数</b>
		<ul>
			<li><em>callBack</em> : Function</li>
			<div class="subDesc">回调函数名。</div>
		</ul>
		<b>返回值</b>
		<ul><li>无</li></ul>
	</div>
	<div class="footer since">@since JSR2.0&nbsp;&nbsp;&nbsp;&nbsp;<a href="ui_Upload_API.html">Return</a></div><br/>
</div>

<a name="onFileClick"></a>
<div class="mdetail alt">
	<h3>onFileClick</h3>
	<div class="functionDefine">public function onFileClick( callBack:Function )</div>
	<div class="mdetailDetails">设置多文件上传域控件的 onFileClickEvent 动作事件回调。<br/>
	callBack 函数必须有一个参数, 当单击控件列表中的文件时, 系统会自动将所选择项的路径文件名做为参数调用 callBack 方法。</div><br/>
	<div class="mdetailDetails"><b>参数</b>
		<ul>
			<li><em>callBack</em> : Function</li>
			<div class="subDesc">回调函数名。</div>
		</ul>
		<b>返回值</b>
		<ul><li>无</li></ul>
	</div>
	<div class="footer since">@since JSR2.0&nbsp;&nbsp;&nbsp;&nbsp;<a href="ui_Upload_API.html">Return</a></div><br/>
</div>

<a name="onSubmit"></a>
<div class="mdetail">
	<h3>onSubmit</h3>
	<div class="functionDefine">public function onSubmit( callBack:Function )</div>
	<div class="mdetailDetails">设置多文件上传域控件的 onSubmitEvent 动作事件回调。<br/>
	当单击控件的上传按钮时, 系统会自动调用 callBack 方法, 本方法只能在AJAX+隐藏iframe上传文件时才有用。</div><br/>
	<div class="mdetailDetails"><b>参数</b>
		<ul>
			<li><em>callBack</em> : Function</li>
			<div class="subDesc">回调函数名。</div>
		</ul>
		<b>返回值</b>
		<ul><li>无</li></ul>
	</div>
	<div class="footer since">@since JSR2.0&nbsp;&nbsp;&nbsp;&nbsp;<a href="ui_Upload_API.html">Return</a></div><br/>
</div>

<a name="reset"></a>
<div class="mdetail alt">
	<h3>reset</h3>
	<div class="functionDefine">public function reset()</div>
	<div class="mdetailDetails">复位多文件上传域控件, 本方法是在AJAX+隐藏iframe上传文件完成后复位控件的。</div><br/>
	<div class="mdetailDetails"><b>参数</b>
		<ul><li>无</li></ul>
		<b>返回值</b>
		<ul><li>无</li></ul>
	</div>
	<div class="footer since">@since JSR2.0&nbsp;&nbsp;&nbsp;&nbsp;<a href="ui_Upload_API.html">Return</a></div><br/>
</div>

</div><br/>

<!--相关事件的详细说明-->
<h2>本类事件的详细说明</h2>
<div class="detailWrap">

<a name="UI.Upload.onDelFileEvent"></a>
<div class="mdetail">
	<h3>UI.Upload.onDelFileEvent</h3><br/>
	<div class="mdetailDetails">
		多文件上传域控件的删除列表文件动作事件。<br/>
		在删除列表文件时将会触发此事件, 具体的应用请参见方法 <a href="#onDelFile" class="methodLink">onDelFile</a> 的说明。
	</div>
	<div class="footer since">@since JSR2.0&nbsp;&nbsp;&nbsp;&nbsp;<a href="ui_Upload_API.html">Return</a></div><br/>
</div>

<a name="UI.Upload.onFileClickEvent"></a>
<div class="mdetail alt">
	<h3>UI.Upload.onFileClickEvent</h3><br/>
	<div class="mdetailDetails">
		多文件上传域控件的单击列表文件动作事件。<br/>
		在单击列表文件时将会触发此事件, 具体的应用请参见方法 <a href="#onFileClick" class="methodLink">onFileClick</a> 的说明。
	</div>
	<div class="footer since">@since JSR2.0&nbsp;&nbsp;&nbsp;&nbsp;<a href="ui_Upload_API.html">Return</a></div><br/>
</div>

<a name="UI.Upload.onSubmitEvent"></a>
<div class="mdetail">
	<h3>UI.Upload.onSubmitEvent</h3><br/>
	<div class="mdetailDetails">
		多文件上传域控件的上传提交动作事件。<br/>
		在点击控件的上传按钮时将会触发此事件, 具体的应用请参见方法 <a href="#onSubmit" class="methodLink">onSubmit</a> 的说明。
	</div>
	<div class="footer since">@since JSR2.0&nbsp;&nbsp;&nbsp;&nbsp;<a href="ui_Upload_API.html">Return</a></div><br/>
</div>

</div><br/>

<!--应用示例-->
<a name="examples"></a>
<h2>应用示例</h2>
<div class="properties"><a href="../Example/ui_Upload.html" target="_blank">ui_Upload.html</a></div><br/>

<!--页脚-->
<hr>
<div class="footer">JSR - Copyright &copy; 2007-2008 Jsr JS, LLC<br/>All rights reserved.</div>
</body>
</html>
